SetAsBackground       NAME, DESKTOP/S, LISTER=WINDOW/S, REQ=REQUESTER/S,
                      TILE/S, CENTER=CENTRE/S, STRETCH/S, PRECISION/K,
                      BORDER/K

(Only OS3.0 or greater)

The SetAsBackground command takes the filename of a picture and installs
it as the background in either the desktop, windows or requesters. The
main use of this command is in a filetype popup menu, whereby you could
click the right mouse button on a picture, select the 'Set As Background'
option and instantly have the picture as your backdrop image. Another use
of this command would be to implement a random background picture
switching application for Opus.

  PRECISION
    Lets you specify the remapping precision; valid values are "none" (no
    remap), "gui" (poor), "icon" (ok), "image" (good), and "exact" (best).
    Please note that the Amiga datatypes system is responsible for
    remapping the images, and so the results achieved may be dependent
    upon your datatypes settings.

  STRETCH
    Causes the picture to be resized to fit the screen.

  BORDER
    If the picture is smaller than the screen, you can specify it as having
    a border of Black, White or Normal.

  CENTER
    Will cause the picture to be centered in the display.

  TILE
    Will cause the picture to be repeated across the screen.  Tiling will
    be enforced if you have the 'Real-time icon scrolling' option enabled
    in  Environment, Icon Settings  and the window is scrollable.